PATHMac OS 8 Developer Documentation > Operating System Services > Multiprocessing Services >

Adding Multitasking Capability to Applications Using Multiprocessing Services

MPSetExceptionHandler

Sets an exception handler for a task.



 
OSStatus MPSetExceptionHandler (

                     MPTaskID task,

                     MPQueueID exceptionQ);

task: A value of type MPTaskID that specifies the task to associate with the exception handler.
exceptionQ: A value of type MPQueueID that specifies the message queue to which an exception message will be sent.
function result: A result code. See Result Codes for a list of possible values.

DISCUSSION

When an exception handler is set and an exception occurs, the task is suspended and a message is sent to the message queue specified by exceptionQ . The message contains the following information:

The first 32-bits contain the ID of the task in which the exception occurred.
The second 32-bits contain the type of exception that occurred. See the header file MachineExceptions.h for a listing of exception types.
The last 32-bits are set to NULL (reserved for future use).

VERSION NOTES

Introduced with Multiprocessing Services 2.0.